This program is free, but I retain the copyright on it.
This program was initially written to assist in the online meetings of the TopSoft group, a group of mac programmers on the Internet, dedicated to producing free, high quality software and sample code. If this program is of use to you, you could help us out by either joining the group (send mail to topsoft@newton.eng.ohio-state.edu (may change in the future, contact me if it fails)), or by providing an FTP site, or a machine on which we could set up mailing lists and/or user accounts for redirecting mail. Any help you could offer us would improve our chances of turning a fledgling group in to the Macintosh equivalent of the Free Software Foundation.
Ñ Contents
What Chat Does
Using Chat
Customising Chat
How It Works
Limitations
Small Print
Warranty
Fine Print
Version History
The Author
Ñ What Chat Does
Chat is a background only application that lets Macs with MacTCP 1.1 serve as a very primitive IRC. Once Chat is running on your mac, multiple people can Telnet to port 1420 on your mac and have online discussions . Chat has no macintosh user interface, the only way to use it is by telneting to your mac. I wrote this to hold the weekly online meetings of the TopSoft group, which have proved very successful. Chat can support upwards of 12 users with the current memory partition (200k), and can support an arbitrarily large number of users given enough memory (though MacTCP will probably blow up if you try too many :-). Add about 5 or 10k for each extra users you want.
Ñ Using Chat
You must have MacTCP 1.1 installed in order to use Chat.
Put Chat or an alias to it in the Startup Folder (System 7) or make it a startup application (System 6 - note you will have to use "Selected Applications and DAs" since background only applications are not counted as Open Applications unbder System 6). Double-Click Chat to get it started now.
Now you need to connect to Chat using NCSA/Telnet, MUDDweller, telnet on unix or VMS machines or some other method...
NCSA/Telnet:
Choose Open Connection from the File Menu, type in the name (or IP number) of your mac, a space and then the port number (1420).
MUDDweller:
Choose New, then choose TCP/IP Address from the configure menu and type in the ip numbers of your mac (or the name for newer versions of MUDDweller), and the port number (1420). Hit OK, and then choose Open Connection from the Configure menu.
Unix:
telnet <macname or ip number> 1420
VMS:
telnet <macname or ip number> /port=1420
Chat is very boring with only one person logged in, so get someone else to log in as well, or log in yourself several times. Once you have connected, you will be asked for a name. This is the name others will see you as when you ╥speak╙. In our online meetings we use the convention of first name and last initial (Ie, I log in as PeterL), but you can use any name you like. Once you press return, you will be given a list of people currently logged on. From now on anything you type will be echoed to all other users in a format like this:
I type ╥Hello╙, and others would see:
PeterL: Hello
Here is a sample session:
unixprompt> telnet mymac 1420
Welcome to Peter's Private Party Line.
Enter your name:PeterL
Welcome, commands are LIST and QUIT, everything else is echoed to all parties.
Warning: Everything said is logged and may be used against you.
list
FredB
Hi Fred, whats up?
FredB: Ahh, fred you showed up. Nothing much, usual stuff.
FredB: How is Chat coming along?
Here, I typed the lines:
telnet mymac 1420
PeterL (third line)
Hi Fred, whats up?
Try it out, you╒ll get the idea pretty quick.
There are two commands that are not echoed. LIST (case is irrelevant), which gives you a list of the people currently logged on (this is done automatically when you first log on), and QUIT (case is irrelevant), which logs you off. There is also a silent command which only the owner should use, QUITNOW (case IS relevant), which closes the server down. Don╒t use this on someone else╒s server!
Ñ Customising Chat
You can customise Chat by using ResEdit to change the STR# resource which contains the port number, the Chat Log name (make it an empty string to disable logging), the Chat Log creator, the three commands (QUITNOW, QUIT, LIST), and all the strings that Chat produces.
Ñ How It Works
Chat is a very simple program, I wrote it in about three hours, plus I've done about three more hours neatifying it, and a couple hours getting it ready to send out. The entire program (ignoring the TCP and other libraries) is only 350 lines, and as such should be a good starting sample code for writing TCP applications (the pascal source code will be sent out as with all my programs).
All it does is listen to the TCP port specified in the STR# resource. When it gets a new connection it starts up another listener, and deals with the user, first getting their name and then echoing all their messages to the other users. It does this by keeping a list of all currently logged on users, when a line comes in from one user, it goes thru the list and echoes it (with the user╒s name prepended) to all other users.
Ñ Limitations
Chat probably require the 128k ROM and System version 6.0 or higher. It may well only work with a Mac IIsi (not mine)-:, and System 7.0. It definitely requires MacTCP v1.1 (and may work with higher versions when they come out, but who knows).
There are several caveats. First, you must terminate your lines every 70 characters or so, it doesn╒t word wrap for you (it should, its easy, I just haven╒t done it). Second, in a ╥crowded room╙, you may have troubles with people all speaking at once (which is not a real problem for users using MUDDweller, but mucks up the screens of users who connect with other clients). The solution we adopted was to start and end you messages with a blank line, so people can tell when you have finished, and avoid interrupting you once you have started.
Ñ Small Print
This program is free, don╒t bother sending me any money for this one, it was only a days work anyway. If you like it, send me an Email message saying hello, or a postcard or something like that.
You may distribute Chat any way you wish as long as you don't charge for it (reasonable download costs such as Compu$erve are ok I guess (although who would call Compu$erve's download costs reasonable?)). It would probably be a good idea to keep this documentation file with the program, but I'm hardly likely to check up on you now am I! I don't guarantee any support, but I always answer my Email (I'm not so good with snail-mail and those horrible little bits of paper and such!). If I don't answer Email its because your message didn't get to me, or my reply bounced (so try again, and include a valid Internet address if you can).
You MAY NOT distribute it on any magnetic media you charge for without my express permission unless you charge less that US$3 for the disks (and no membership costs). I am sick and tired of seeing people selling PD/Shareware software for five or ten dollars a disk without any reimbursement to the authors.
Ñ Warranty
There is absolutely NO warranty, guarantee, hint, suggestion or anything else that would lead anyone to think that Chat do anything stated in this documentation. It usually does not destroy data (systems, hardware, etc), and has sometimes worked on my Mac with System 7.0. It is highly unlikely that it will work with older systems (pre 6.0 anyway) or with the 64k ROM. It might work with the other models, but I don't have them all, so I don't know (Anyone want to give me a IIfx (or one of those new beasts? How did they come up with such a terrible name???) so I can check for compatibility?). It might work with future versions of MacTCP (after 1.1), but who can tell? If it works on your system (or especially if it doesn't!), send me a postcard or some Email and let me know!
Ñ Fine Print
Peter Lewis hereby disclaims all warranties relating to this software, whether express or implied, including without limitation any implied warranties of merchantability or fitness for a particular purpose. Does any one really read this stuff. Peter Lewis will not be liable for any special, incidental, consequential, indirect or similar damages due to loss of data or any other reason, even if Peter Lewis or an agent of his has been advised of the possibility of such damages. In no event shall Peter Lewis be liable for any damages, regardless of the form of the claim. The person using the software bears all risk as to the quality and performance of the software.
Ñ Version History
Still to do -
Word wrapping lines.
Perhaps a password facility.
v1.0.0
~Moved strings into resource fork.
~Improved strings
Ñ The Author
Other programs also written by me:
DeHQX 2.0.0 - BinHex decoder
Finger 1.3.5 - Macintosh Finger client/daemon
Talk 1.0.6 - Macintosh Talk client/daemon
Send postcards, comments, bug reports, and wishes to:
